_____________________________________________________________________________

                             Q u i c k F i l e r

         Allows the Filer to be controlled by means of the keyboard

                          by David Thomas,  1997-8
                         version 1.28 (01 Jun 1998)
_____________________________________________________________________________


 Introduction ______________________________________________________________

QuickFiler is a utility which allows you to use many standard shortcut keys
in conjunction with the RISC OS Filer.

QuickFiler requires a Risc PC-style !Boot application.


 Installation ______________________________________________________________

Before you can use QuickFiler, it must be installed into your computers boot
sequence and your machine must be restarted.

Install QuickFiler by running the supplied !Installer application.  This will
copy across the program files to their correct place within the Boot
application and generate new menu structures for the Filer.

Upon restarting your machine, you will find that the Filer gains the input
focus when you click in its windows and that the Filer menu displays the
associated shortcut next to certain items.  Simply pressing the shortcut key
combination will activate that item.


 Shortcuts _________________________________________________________________

QuickFiler provides the following shortcut keys ( is SHIFT, ^ is CTRL):

  Large icons..........F2  Sort by name........F1  Select all...........^A
  Small icons..........F3  Sort by type........F2  Clear selection......^Z
  Full info............F4  Sort by size........F3  Open parent..........^B
                           Sort by date........F4  Close window........^F2

  Delete.....DELETE or ^X  Confirm..............F5  Protect.............^F5
  Count................^N  Verbose..............F6  Unprotect...........^F6
  Help.................^H  Force................F7  Public..............^F7
  Stamp................^S  Newer................F8  Private.............^F8

  Scroll up............UP  Page up.........PAGE UP  Scroll to top.......^UP
  Scroll down........DOWN  Page down.....PAGE DOWN  Scroll to bottom..^DOWN

QuickFiler works by fakeing the actions of the user selecting Filer menu
entries.  This means certain shortcuts - in particular those which would
activate sub-menus - have not been implemented, as I have not yet found a
way to fake them cleanly.


 Removal ___________________________________________________________________

Should you wish to remove QuickFiler from your system, you must remove the
following two directories:

                      !Boot.Choices.Boot.PreDesk.QFiler

                      !Boot.Choices.Boot.Tasks.!QFiler

Note that if you change operating system - for example an upgrade to RISC OS
3.7, after installing a StrongARM card - you should reinstall QuickFiler.


 History ___________________________________________________________________

1.00 (22 May 1997)
 - First Release.

1.10 (22 Oct 1997)
 - Thanks to Reuben Thomas, Chris Ward and Ian Scott for pointing out that
   QuickFiler didnt work on RISC OS 3.7 due to missing Message tokens.
   This version now reads the Filer messages from ROM and converts them
   appropriately before installing.
 - Templates file is not supplied anymore.
 - An Installer program, to facilitate the above.
 - Keys are referred to as 'shortcuts' now, rather than 'hot-keys'.

1.25 (02 Apr 1998)
 - Added Ctrl-F2 to close directory viewer window (James Lawson suggested.)
 - Responds correctly to Filer and FilterManager resets and reinits.
 - The module has been recoded in key areas, so despite the new features its
   only slightly bigger than the previous version.

1.28 (01 Jun 1998)
 - Fix: Service call handling was faulty, leading to problems when new
   desktop Filers were activated. e.g. RAMFS Filer.
 - Fix: The way Ctrl-F2 was implemented turned out to be not acceptable.  It
   has been reimplemented in the correct manner.  Note that Shift-Ctrl-F2
   will duplicate the action of ^B (Open parent) due to the way that this
   works.
 - Fix: Key Pressed events are not now passed on to the Filer if they are
   handled, stopping the keypresses getting passed on to tasks with hot key
   windows.  Reported by Brian Howlett.
 - Some new function keys: :-)
     Up, Down            - move up or down by one icon row
     ^Up, ^Down          - move to the top or bottom of the display
     Page Up, Page Down  - move up or down by one page


 Credits ___________________________________________________________________

Thanks to Ting Zwei Kuei for writing FilerKeys which didnt work quite how I
wanted it to, so I wrote this!

Many thanks to Andrew Clover for the WimpSWIVe module which makes an
otherwise impossible job, possible. :-)  The WSWI-Help document (supplied)
documents the module.


 Copyright & Contact Addresses _____________________________________________

  This software is copyrighted work of David Thomas, it is supplied as is;
using it is entirely at your own risk.  I make no warranty as to the fitness
of this software for any purpose.  You are free to distribute this program
toanyone you please, as long as you are not supplying it for personal or
commercial gain and it is delivered with all of the supplied files unaltered.

  If you have any comments, bug reports, suggestions for future versions or
anything else dont hesitate to contact me at -

  Mail:  Mr D.P. Thomas
         20 Rosebery Avenue
         Waterloo
         Liverpool
         L22 2BH

  Email: dpt@tristone.co.uk

  WWW:   http://www.tristone.co.uk/davespace/
_____________________________________________________________________________

